From: Matthias Clasen <mclasen@redhat.com>
Date: Wed, 25 Jul 2012 02:11:18 +0000 (+0200)
Subject: Some updates to the man page
X-Git-Tag: archive/raspbian/50.5-1+rpi1~1^2~1013^2^2~5487
X-Git-Url: https://dgit.raspbian.org/%22http://www.example.com/cgi/%22/%22http:/www.example.com/cgi/%22?a=commitdiff_plain;h=5c16be5dbb6fd5efc8c0d6c424e09e8cf6236e76;p=gnome-shell.git

Some updates to the man page

Mention relevant files, and how gnome-shell gets started
in the session.

https://bugzilla.gnome.org/show_bug.cgi?id=680601
---

diff --git a/man/gnome-shell.xml b/man/gnome-shell.xml
index 7e43536cb..fa9e7d15b 100644
--- a/man/gnome-shell.xml
+++ b/man/gnome-shell.xml
@@ -45,6 +45,13 @@
                 and introduces innovative user interface concepts to provide
                 a visually attractive and easy to use experience.</para>
 
+                <para>gnome-shell is a required component of
+                the GNOME desktop, i.e. it is listed in the
+                RequiredComponents field of
+                <filename>/usr/share/gnome-session/sessions/gnome.session</filename>.
+                It is started in the window manager phase of the session.
+                </para>
+
         </refsect1>
 
         <refsect1>
@@ -53,7 +60,7 @@
                 <variablelist>
 
                         <varlistentry>
-                                <term><option>--replace</option></term>
+                                <term><option>-r</option>, <option>--replace</option></term>
 
                                 <listitem><para>Replace the running window manager</para></listitem>
                         </varlistentry>
@@ -106,10 +113,30 @@
                                 <listitem><para>Display help and exit</para></listitem>
                         </varlistentry>
 
+                        <varlistentry>
+                                <term><option>--mode=<replaceable>MODE</replaceable></option></term>
+
+                                <listitem><para>Use a specific mode, e.g. "gdm" for login screen</para></listitem>
+                        </varlistentry>
+
+                        <varlistentry>
+                                <term><option>--list-modes</option></term>
+
+                                <listitem><para>List possible modes and exit</para></listitem>
+                        </varlistentry>
+
                 </variablelist>
 
         </refsect1>
 
+        <refsect1>
+                <title>Files</title>
+
+                <para>
+                        <filename>/usr/share/gnome-session/sessions/gnome.session</filename>,
+                        <filename>/usr/share/applications/gnome-shell.desktop</filename>.</para>
+        </refsect1>
+
         <refsect1>
                 <title>Bugs</title>